User description

from #278

User description

Summary

This PR adds a native Android port of OpenLess under openless-android/.

The Android implementation ports the desktop dictation pipeline into Java/Android-native components, including:

• floating trigger service replacing desktop hotkeys
• microphone foreground service flow
• Volcengine streaming ASR
• Whisper-compatible ASR
• OpenAI-compatible polish / translation / Q&A
• IME insertion with clipboard fallback
• history, dictionary, settings, model list, Q&A, and error/detail screens
• Android-side build / verify / deploy scripts and release checklists

Included

• new Android app module in openless-android/
• native Activities for:
  • main screen
  • settings
  • dictionary
  • history detail
  • model list
  • Q&A
  • error detail
• floating capsule service and notification actions
• Android Keystore-backed secure storage
• documentation for build, release, QA, and port status

Validation

Verified locally with:

• .\build.ps1
• .\verify.ps1

Also completed one emulator validation round for:

• main sections
• settings
• dictionary
• Q&A page
• APK install / launch

Notes

This is a large additive PR because the Android port is introduced as a new directory rather than modifying the existing desktop implementation.

Known remaining work is mainly around:

• real-device / real-credential end-to-end validation
• release signing and store submission assets
• further UI parity and final polish

PR Type

Enhancement, Documentation

Description

• Android port with build/verify/deploy scripts and version sync

• Main dictation flow: floating trigger, mic recording, streaming ASR

• Polish, translation, and IME insertion with clipboard fallback

• History, dictionary, settings, Q&A, and error detail screens

Diagram Walkthrough

flowchart LR
  A["build.ps1 / verify.ps1 / deploy.ps1"] -- "generates" --> B["APK"]
  B --> C["MainActivity"]
  C --> D["FloatingTriggerService"]
  C --> E["AudioRecorder"]
  E --> F["VolcengineStreamingSession"]
  F --> G["OpenAiPolishProvider"]
  G --> H["TextInserter (IME/Clipboard)"]
  C --> I["HistoryStore / DictionaryStore"]
  C --> J["SettingsActivity / QaPanelActivity"]

PR Type

Enhancement, Documentation

Description

• Adds native Android OpenLess app

• Implements dictation, QA, and IME flows

• Adds build, verify, deploy scripts

• Documents release, QA, port status

Diagram Walkthrough

flowchart LR
  V["version.ps1 derives Android versioning"] --> B["build.ps1 compiles and signs APK"]
  B --> P["verify.ps1 checks APK metadata"]
  B --> D["deploy.ps1 installs to device"]
  A["Android app module"] --> M["MainActivity and core flows"]
  A --> Q["QaPanelActivity voice question UI"]
  A --> S["SettingsStore and settings screens"]
  A --> F["FloatingTriggerService overlay trigger"]
  A --> I["OpenLessInputMethodService IME insertion"]
  A --> R["Docs, checklists, and manifest"]